---
title: Upgrade naar v5
description: Hoe u uw project van Ultracite v4 naar v5 bijwerkt.
---

Ultracite v5 is een major release met significante verbeteringen en breaking changes. Deze gids helpt u uw bestaande v4-configuratie naar v5 te upgraden.

## Wat is er nieuw in v5

- **Bijgewerkte Biome**: Bijgewerkt van v1.x naar v2.x
- **Nieuw configuratieformaat**: Overschakelen van `biome.json` naar `biome.jsonc`
- **Verbeterde CLI**: Herschreven in TypeScript met betere foutafhandeling
- **Editor-integraties**: Ingebouwde ondersteuning voor Cursor, Windsurf, Zed en GitHub Copilot
- **Git Hooks**: Optionele integraties waaronder Husky, lint-staged en lefthook
- **Verbeterd schema**: Nieuwe schema-URL met betere validatie
- **Vereenvoudigde VS Code-instellingen**: Gecombineerde bestandstype-overschrijvingen in één regel

## Migratiestappen

### Automatische migratie (Aanbevolen)

De gemakkelijkste manier om te migreren is het nieuwe initialisatiecommando uit te voeren:

```package-install
npx ultracite@latest init
```

Dit zal:
- Uw afhankelijkheden bijwerken naar de nieuwste versies
- Uw `biome.json` of `biome.jsonc` bijwerken  
- Uw VS Code-instellingen bijwerken
- Aanbieden om AI-editorregels in te stellen (Cursor, Windsurf, Zed, enz.)
- Aanbieden om nieuwe integraties in te stellen (Git hooks, lint-staged, enz.)

Na de upgrade wilt u wellicht uw `biome.json` / `biome.jsonc` bestand controleren om eventuele overrides te verwijderen. Start bovendien uw editor opnieuw op om ervoor te zorgen dat de nieuwe configuratie wordt toegepast.

Bekijk daarnaast de Biome [v2-upgradegids](https://biomejs.dev/guides/upgrade-to-biome-v2/) voor meer informatie over schema- / regelwijzigingen.

### Handmatige migratie

Als u liever meer controle over het proces hebt, volg dan de stappen van de [Handmatige migratie](/setup#manual-installation) door:

- De bijgewerkte versies van Ultracite en Biome handmatig te installeren
- Uw `biome.json` bestand bij te werken naar de nieuwe schema-versie
- Het `.vscode/settings.json` bestand bij te werken (optioneel)
- Een AI-editorregelsbestand toe te voegen (optioneel)
- Nieuwe integraties toe te voegen (optioneel)

Start na de migratie uw editor opnieuw op om ervoor te zorgen dat de nieuwe configuratie wordt toegepast.